home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / bowling.arc / BOWLPRT1.TXT < prev    next >
Text File  |  1985-07-17  |  12KB  |  249 lines

  1. b/A.space1
  2. .PAGE
  3. .LINES60
  4. .space1
  5.                 BOWLING LEAGUE SECRETARY'S SYSTEM
  6.               PROGRAM DESCRIPTION/OPERATIONS MANUAL
  7.                           SEPTEMBER 1982
  8. .EJECT
  9. .space1
  10.                      TABLE OF CONTENTS
  11.      System Overview . . . . . . . . . . . . . . . . . . 1
  12.      File Descriptions . . . . . . . . . . . . . . . . . 2
  13.      Program Descriptions  . . . . . . . . . . . . . . .10
  14.      Setup and Operations  . . . . . . . . . . . . . . .14
  15.  
  16.  
  17.  
  18.    All questions about the system may be directed to:
  19.  
  20.           William W. Klaproth
  21.           1897 Joseph Drive
  22.           Moraga Ca.    94556
  23.           415/376-0708
  24.  
  25.           B/O GPC
  26.           Oakland Ca.
  27.           Tie 8/648-5337
  28. .eject
  29. .space1
  30. .TITLEA,3,     BOWLING LEAGUE SECRETARY'S SYSTEM.page3,78,#1                     SYSTEM OVERVIEW
  31.  
  32.  
  33.      This system is comprised of twelve programs, representingover 1600 lines of code.  The system is written in ADVANCED BASICfor a 64K IBM Personal Computer with one or two disks and printer. 
  34.      The system is highly generalized, permitting initializationof most items including:
  35.          League Name
  36.          Team Configuration
  37.          Handicap basis
  38.          Schedule
  39.  
  40.      As distributed, the system can handle 18 teams, up to 5bowlers per team, and up to a 50 week season.  The 18 team limitis a function of the 80 character print line width used to printschedules.  If this function is appropriately modified, or notused, a much larger number of teams can be accommodated.  Theactual limit is a function of diskette capacity, bowlers per team, and number of weeks.
  41.  
  42.      Programs are provided to initialize all master files, enterscores and print standings (weekly), as well as prepare Bookaverage listings, final team/bowler standings, and display orprint individual team/bowler record sheets.
  43.  
  44.      The system is designed to be used on either a one or two diskdrive system.  Program selection is controlled by a master MENUprogram.  The program diskette is assumed to be in the A drive. Except for the smallest leagues, you will need to maintain allbowler files on the B drive.  In a single drive environment, DOSwill provide prompts to insert the appropriate diskette.  Justremember - Drive A = PROGRAMS;  Drive B = FILES.
  45. .eject
  46. .space1
  47.                       SUMMARY OF FILE USAGE
  48.  
  49.  *               
  50.    * File    1        2       3       4           5          6
  51.      *     
  52.        *   TEAMS.  BOWLERS.  TEAM.  BOWLER.  HISCORES.  SCHEDULE.
  53. Program  *  HDR      HDR      DET    .DET        DET       DET
  54. ---------- -----    ------   ----    -----     ------     ------
  55.  
  56. CREATE       C        C        C       C           
  57.  
  58. SCHEDULE                                                    C
  59.  
  60. CHANGE       U        U
  61.  
  62. SCORES       U        U        U       U          C
  63.  
  64. RECAP        I        I        I       I          I         I 
  65.  
  66. RECORDD      I        I        I       I
  67.  
  68. RECORDP      I        I        I       I
  69.  
  70. SORTFILE     I        I        I       I 
  71.  
  72. FINAL        I        I
  73.  
  74. PRINT        I        I
  75.  
  76. DETAIL       I                 I       I
  77.  
  78.      The Table above contains a summary of file creation andusage.  All bowling files are Random Files, and are written inpacked binary format.  In the table above, "C" indicates where afile is created, "U" where it is updated, and "I" where it is used as input.
  79.  
  80.      The following pages contain more detailed information on each file.  The format column shows type of data representation:
  81.           
  82.               I = Integer string
  83.               S = Single precision value string
  84.               D = Double precision value string
  85.               A = Character string
  86. .eject
  87. .space1
  88.                  FILE DESCRIPTIONS
  89.  
  90. File # 1 - TEAMS.HDR   (Team Header File)
  91.  
  92. From To Lgth Format Name       Description                     
  93. ---- -- ---- ------ ---------  -----------                     
  94.   RECORD NUMBER 1 - LEAGUE HEADER
  95.  1    2   2    I    HDRID$     Header ID  (Value="00")
  96.  3   32  30    A    LEAGUE$    Name of League
  97. 33   34   2    I    WEEKS$     Number of Weeks
  98. 35   36   2    I    TEAMS$     Number of Teams
  99. 37   40   4                    Not Used
  100. 41   42   2    I    BWLPERTM$  Bowlers per Team
  101. 43   44   2    I    NXTID$     Next Avail. ID
  102. 45   46   2    I    HCPBASE$   Handicap Base
  103. 47   50   4    S    HCPPCNT$   Handicap %
  104. 51   64  14                    Not Used
  105.  
  106.   RECORD 2 THRU nn - TEAM HEADERS
  107.  1    2   2    I    TM$        Team Number
  108.  3   32  30    A    NAM$       Team Name
  109. 33   34   2    I    RCNT$      Number of Detail Records on File
  110. 35   36   2    I    GAM$       Team Games Bowled
  111. 37   40   4    S    PINS$      Total Team Pins
  112. 41   42   2    I    AVG$       Team Average
  113. 43   44   2    I    HIG$       High Team Game (Scratch)
  114. 45   46   2    I    HIS$       High Team Series (Scratch)
  115. 47   50   4    S    PTSW$      Total Team Points Won
  116. 51   54   4    S    PTSL$      Total Team Points Lost
  117. 55   56   2    I    B1ID$      ID Number of 1st Bowler
  118. 57   58   2    I    B2ID$      ID Number of 2nd Bowler
  119. 59   60   2    I    B3ID$      ID Number of 3rd Bowler
  120. 61   62   2    I    B4ID$      ID Number of 4th Bowler
  121. 63   64   2    I    B5ID$      ID Number of 5th Bowler
  122.  
  123.      Record #1 on this file is the league header, which containsthe variable data for the entire league.  The NXTID$ fieldindicates the next available bowler ID and is used by the CHANGEprogram when adding new bowler records.  This field cannototherwise be updated.
  124.      Records 2 thru n contain Team header data.  RCNT$ is acontrol filed and indicates the number of detail records on theTEAM.DET file.  There is one header record per team.  Its      relative record address is the Team number + 1.
  125.      The ID numbers of bowlers assigned to each team are storedin the BxID$ fields which begin at position 55.  Bowlers can beshifted among teams by changing these fields and the BTM$field in the BOWLERS.HDR record.  (See description for file #2).     NOTE:  Total team pins (37-40) represents total pincount(including handicap).  If scratch total pins is preferred, thelogic affecting this field may be found at lines 2050-2180 in theSCORES program.
  126. .eject
  127.                     .space1
  128.                  FILE DESCRIPTIONS
  129.  
  130. File # 2 - BOWLERS.HDR   (Bowler Header File)
  131.  
  132. From To Lgth Format Name       Description                     
  133. ---- -- ---- ------ ---------  -----------                     
  134.  
  135.   1    2   2    I    BBO$       Bowler Number
  136.  3   32  30    A    BNAM$      Bowler Name
  137. 33   34   2    I    BRCNT$     Number of Detail Records on File
  138. 35   36   2    I    BGAM$      Total Games Bowled
  139. 37   40   4    S    BPINS$     Total Pins
  140. 41   42   2    I    BAVG$      Average
  141. 43   44   2    I    BHIG$      High Game (Scratch)
  142. 45   46   2    I    BHIS$      High Series (Scratch)
  143. 47   48   2    I    BHCP$      Handicap
  144. 49   50   2    I    BHIGH$     High Handicap Game
  145. 51   52   2    I    BHISH$     High Handicap Series
  146. 53   54   2    I    BTM$       Bowlers Team Number
  147. 55   56   2    I    GAM2$      Number of 200 Games
  148. 57   58   2    I    SER5$      Number of 500 Series
  149. 59   60   2    I    SER6$      Number of 600 Series
  150. 61   62   2    I    CURSER$    Current (Last) Series
  151. 63   64   2    I    AVGLSTYR$  Average Last Year
  152.  
  153.  
  154.      This file contains one record per bowler and is updated bythe SCORES program.  BHCP$ is initialized to 0 by CREATE andupdated with handicap only if 21 or more games have been bowled. The current series field (CURSER$) is also used to keep track ofconsecutive absences.
  155.      BTM$ indicates which team the bowler is assigned to.  For asubstitute, this field is 0.  Bowlers can easily be shifted amongteams and/or sub status by changing this field, as well as theBowler ID fields (pos 55-64) of the TEAMS.HDR records.  Refer tothe section on File Relationships later in this chapter foradditional information.
  156.      BRCNT$ is a control field and indicates the number of detailrecords on the BOWLER.DET file..eject
  157.  .space1
  158.                  FILE DESCRIPTIONS
  159. File # 3 - TEAM.DET (Team Detail Records)
  160.  
  161. From To Lgth Format Name       Description                     
  162. ---- -- ---- ------ ---------  -----------                     
  163.  
  164.   1    2   2    I    DTM$       Team Number
  165.  3    4   2    I    TMO$       Month
  166.  5    6   2    I    TDAY$      Day
  167.  7    8   2    I    TG1$       Team Game 1 Score
  168.  9   10   2    I    TG2$       Team Game 2 Score
  169. 11   12   2    I    TG3$       Team Game 3 Score
  170. 13   14   2    I    TSER$      Team Series Score
  171. 15   16   2    I    DPTSW$     Team Points Won
  172.  
  173.  
  174.      This file stores the weekly detail records for each team. A randomizing routine is used to compute record addresses.  Up to50 weeks of detail records can be stored for each team.  Game andseries scores stored in this file are handicap scores.
  175. .eject
  176. .space1
  177.                  FILE DESCRIPTIONS
  178.  
  179. File # 4 - BOWLER.DET (Bowler Detail Records)
  180.  
  181. From To Lgth Format Name       Description                     
  182. ---- -- ---- ------ ---------  -----------                     
  183.  
  184.   1    2   2    I    DBO$       Bowler Number
  185.  3    4   2    I    BMO$       Month
  186.  5    6   2    I    BDAY$      Day
  187.  7    8   2    I    BG1$       Game 1 Score
  188.  9   10   2    I    BG2$       Game 2 Score
  189. 11   12   2    I    BG3$       Game 3 Score
  190. 13   14   2    I    BSER$      Series Score
  191. 15   16   2    I               Not Used
  192.  
  193.  
  194.      This file contain weekly bowler detail records.  Arandomizing routine is used to compute record address.  Up to 50weeks of scores can be stored for each bowler.  All scoresrecorded in this file are scratch scores.
  195. .eject
  196. .space1
  197.                  FILE DESCRIPTIONS
  198.  
  199. File # 5 - HISCORES.DET (High Scores File)
  200.  
  201. From To Lgth Format Name       Description                     
  202. ---- -- ---- ------ ---------  -----------                     
  203.  
  204.   1    2   2    I    HBNO$      Bowler Number
  205.  3    4   2    I    HG1$       Game 1 Score
  206.  5    6   2    I    HG2$       Game 2 Score
  207.  7    8   2    I    HG3$       Game 3 Score
  208.  9   10   2    I    HSER$      Series Score
  209. 11   11   1    A    HFLG1$     Game 1 Flag
  210. 12   12   1    A    HFLG2$     Game 2 Flag
  211. 13   13   1    A    HFLG3$     Game 3 Flag
  212. 14   14   1    A    HFLGS$     Series Flag
  213. 15   16   2    I    HCNT$      Flag Count
  214.  
  215.  
  216.      This file is created by SCORES and processed by RECAP.  Onerecord is written for each bowler and contains the complete scoreand flags indicating the following mentionable high scores:
  217.  
  218.           200+ game
  219.           500+ series
  220.           any game 50 pins or more above average
  221.  
  222.      The logic associated with this file is located between lines1020-1390 in the SCORES program.  The actual determination ofwhich scores to highlight is a function of the RECAP program.
  223. .eject
  224. .space1
  225.                  File Descriptions
  226.  
  227. File # 6 - SCHEDULE.DET (Schedule File)
  228.  
  229. From To Lgth Format Name       Description                     
  230. ---- -- ---- ------ ---------  -----------                     
  231.  
  232.   1    1   1    A    STATUS$    Status (Reserved for future use
  233.  2    3   2    I    WEEK$      Week number
  234.  4    5   2    I    SMO$       Month
  235.  6    7   2    I    SDY$       Day
  236.  8   75  68    A    PRLINE$    Text line
  237.  
  238.  
  239.      This file is created at the begining of the season by theSCHEDULE program and is processed weekly by RECAP.  A free formatis provided so that in addition to team pairings, special messages can be entered.
  240.  
  241.        e.g.    DATE\ LANE  1:2    3:4    5:6    7:8
  242.                -----      -----  -----  -----  -----
  243.  
  244.                11/17       5-7    3-6    1-8    4-2
  245.                11/24      Happy Thanksgiving - No bowling
  246.                11/31       2-3    5-7    8-6    4-1
  247.                12/06      P O S I T I O N    R O U N D
  248. .eject
  249. located betwee